home *** CD-ROM | disk | FTP | other *** search
-
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 1
-
-
-
- README.DOC for FLASH-Gate(TM) - June 12, 1993
- ===============================================
-
- Copyright (C) 1993 by Frango KB. All rights reserved.
-
-
- Trademarks and acknowledgments:
-
- LANtastic is a registered trademark of Artisoft Inc.
- Futurus TEAM is a trademark of Futurus Corporation.
- MHS was originally developed by Action Technologies.
- cc:Mail is a trademark of cc:Mail, Inc., a wholly-owned subsidiary of
- Lotus Development Corporation.
- WP Office is a trademark of Word Perfect Corporation.
-
- FLASH-Gate is a trademark of Frango KB.
-
-
- NICK Systems
- 9005 Exposition Blvd
- Los Angeles, CA 90034
- U.S.A.
-
- Phone: (310)841-2901
- Fax: (310)785-1050
- MHS: SALES@COLORSHP or TECH@COLORSHP via NHUB or direct
- (310)841-2074
-
-
- LICENSES, WARRANTIES AND DISCLAIMERS
- ====================================
-
- I. The trial version of FLASH-Gate(TM) may be distributed via
- electronic mail or electronic BBS's and information services as
- long as the contents of this archive have not been modified. The
- trial version of the software may be included with other packages
- or publications only with the permission of Frango.
-
- II. The registered version of FLASH-Gate(TM) may not be redistributed,
- and the normal rules of commercial copyrighted software apply.
-
- III. NO WARRANTY. ANY USE BY YOU OF THE SOFTWARE IS AT YOUR OWN RISK.
- THE SOFTWARE IS PROVIDED FOR USE AS IS WITHOUT WARRANTY OF ANY
- KIND. FRANGO AND NICK SYSTEMS DISCLAIM ALL WARRANTIES OF ANY KIND,
- EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, IMPLIED
- WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-
-
- FLASH-Gate(TM) Trial Version
- ============================
-
- The trial version works exactly the same way as the retail package,
- except that the trail program will expire when the trial period is over.
- You can the acquire a retail package from NICK Systems and install it
- without loosing your existing data.
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 2
-
-
- INTRODUCTION
-
- FLASH-Gate(TM) is an MHS Gateway that connects LANtastic(R) Mail to MHS.
- It allows you to send messages between LANtastic(R) Mail programs (like
- LANtastic's Mail and rMail) and MHS E-mail programs (like Futurus
- TEAM(TM)). The gateway also lets you connect LANtastic(R) Mail servers
- for message interchange with each other using MHS. It also opens up the
- possibility to communicate with other platforms (cc:Mail, WP Office
- etc.) from LANtastic(R) Mail using the proper MHS gateways.
-
-
- ==> Features
- * Send message from MHS to LANtastic(R) Mail.
- * Send message from LANtastic(R) Mail to MHS.
- * Send message from LANtastic(R) Mail to other LANtastic(R) Mail
- server/location (remote or local) via MHS.
- * Supports sending of binary files from LANtastic(R) Mail to MHS as
- MHS attachments.
- * MHS messages with file attachments sent to LANtastic(R) will be
- broken up to several LANtastic(R) Mail messages, one for the MHS
- body part, and one for each MHS attachment.
- * MHS to LANtastic(R) Mail addressing is done via a standard MHS
- address with an extended part.
- * LANtastic(R) Mail to MHS addressing is done either via an address
- translation table, or the MHS address can be taken from the first
- line of the LANtastic(R) message.
- * The LANtastic(R) address (to MHS) shortname/alias can be selected
- from the LANtastic(R) user list. The shortname/alias in the
- translation table can be a group and consist of any number and type
- of MHS addresses.
-
-
- ==> System requirements
-
- FLASH-Gate(TM) requires MHS 1.5 and LANtastic(R) 3.X or later.
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 3
-
-
- ADDRESSING AND CONVERSIONS
-
- Parts of the following chapter are a bit technical in nature, and are
- more for your reference. The important parts must be read and understood
- are the sections "Addressing a LANtastic(R) Mail user in MHS" and
- "Addressing an MHS user in LANtastic(R) Mail". Before you continue
- reading, make sure you know how to address messages in LANtastic(R) Mail
- and MHS. The following chapter requires basic knowledge of MHS and
- LANtastic(R) Mail.
-
-
- ==> Sending E-mail from MHS to LANtastic(R) Mail
-
-
- => Addressing a LANtastic(R) Mail user in MHS
-
- The addressing of a LANtastic(R) Mail user is done via the MHS extended
- address part. The address is of the type:
-
- LANTMAIL @HOST {LANtastic: S=SERVER; U=USER;}
-
- Where:
- * "LANTMAIL" is the name of the MHS gateway that you selected during
- installation. (Default name is LANTMAIL).
- * "HOST" is the name of your MHS host/workgroup.
- * "SERVER" is the name of the LANtastic(R) server that the user
- resides on.
- * "USER" is the LANtastic(R) username.
-
- A typical address might look like:
-
- LANTMAIL @FRANGO {LANtastic: S=SERVER1; U=MIKE;}
-
- How you enter an address depends on your MHS E-mail package. Please
- consult your E-mail documentation on how to do this.
-
-
- => Invalid address(es)
-
- If the LANtastic(R) Mail address in the MHS message was invalid, the
- sender of the MHS message will get a non-delivery report stating the
- problem. However, the sender is responsible that the LANtastic(R)
- username is correct, just as when sending a message from LANtastic(R)
- Mail.
-
-
- => Conversions MHS =>> LANtastic(R) Mail
-
- All visible MHS headers (like To, From, Date, Subject, etc.) will be
- copied to the LANtastic(R) message together with the MHS message body.
-
- The MHS "Subject:" header will also be truncated to 47 characters and
- put in the LANtastic(R) Mail "Comment" field.
-
- MHS Messages with attachments will be split up into several LANtastic(R)
- Mail messages. The MHS headers and body will be copied to the first
- LANtastic(R) message, then there will be one additional LANtastic(R)
- message for each MHS attachment. The LANtastic(R) messages that are
- converted from MHS attachments will have the Voice mail flag set to
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 4
-
-
- distinguish them from text files.
-
-
- ==> Sending E-mail from LANtastic(R) Mail to MHS
-
-
- => Addressing an MHS user in LANtastic(R) Mail
-
- Since there is no way of entering a more complicated address in
- LANtastic(R) Mail, addresses must be translated via a translation table.
- This translation table contains shortnames/aliases (following
- LANtastic(R) username conventions) and their corresponding full MHS
- addresses.
-
- The translation table file is named "LANTMAIL.TAB" and is located in the
- %MAIL%\GATES\LANTMAIL\PUBLIC (or %MV%\MHS\MAIL\GATES\LANTMAIL\PUBLIC)
- subdirectory. For example if you have installed MHS on the drive "F:"
- and kept the default FLASH-Gate(TM) gateway name "LANTMAIL", the full
- path of the file is:
-
- "F:\MHS\MAIL\GATES\LANTMAIL\PUBLIC\LANTMAIL.TAB"
-
- The translation table (LANTMAIL.TAB) is a standard ASCII file and
- consists of one line for every alias/address entry. Each line/entry has
- the following format:
-
- ALIAS,TYPE,MHS ADDRESS
-
- Where:
- * "ALIAS" is the alias/shortname to be used when sending a
- LANtastic(R) message. It follows the LANtastic(R) username
- conventions (max 16 characters), and can be picked from the
- LANtastic(R) user list if it has been entered as a username in
- NET_MGR. But the alias does not necessarily have to be entered as a
- LANtastic(R) username as long as it is defined in LANTMAIL.TAB. The
- alias must start with the characters "MHS:".
- * "TYPE" is the address type. 'N' stands for "normal" addresses,
- meaning the MHS address(es) will be picked from "MHS ADDRESS". 'O'
- means it is a one-off address, and the MHS address(es) will be
- picked up from the first line(s) of the LANtastic(R) message.
- * "MHS ADDRESS" is the MHS address(es) that should be used in the
- message instead of the alias. This can be just one address or a
- group with any number of addresses, as long as the total line
- length is less than 512 characters.
-
- Example "LANTMAIL.TAB":
-
- ******************************************************************
- MHS:ONE-OFF,O,The address field is not used for ONE-OFF
- MHS:FRANGO-CJ,N,CJ @FRANGO
- MHS:FRANGO-MIKE,N,LANTMAIL @FRANGO {LANtastic: S=SERVER1; U=MIKE;}
- MHS:SALESGROUP,N,CJ @FRANGO, SALES @NICK, SALES @COLORSHP
- ******************************************************************
-
- For example, if you pick/type the address "MHS:FRANGO-CJ" in the "Enter
- User to Receive Mail" field when sending a LANtastic(R) message, the
- gateway will convert it to the corresponding MHS address, "CJ@FRANGO".
-
- If you instead would want the address(es) to be picked from the message
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 5
-
-
- itself (for example if the destination user hasn't been entered in the
- translation table), enter the address(es) as the first line(s) of the
- LANtastic(R) message. This address follows the MHS standard address
- format. Addresses are separated with commas (",") and can be split up on
- several lines by having the continuation lines begin with a space or a
- tab.
-
- Example LANtastic(R) message with "ONE-OFF address:
-
- ******************************************************************
- CJ @FRANGO, SALES @NICK,
- TECH @NICK
- This is the first line of the LANtastic message itself.
- Here comes the second line...
- ******************************************************************
-
- By selecting/typing "MHS:ONE-OFF" in the "Enter User to Receive Mail"
- field when sending this LANtastic(R) message, the message will be
- delivered to the three recipients "CJ@FRANGO", "SALES@NICK" and
- "TECH@NICK".
-
-
- => Invalid address(es)
-
- If the "ALIAS" you selected is not defined in the translation table, the
- message will remain in your "OUTgoing Mail" box and never be picked up.
- When the message disappears from your "OUTgoing Mail" box, you know that
- the message has been sent off by FLASH-Gate(TM). To be sure that your
- messages are successfully sent, check your "OUTgoing Mail" box
- periodically.
-
-
- => Conversions LANtastic(R) Mail =>> MHS
-
- The MHS headers are constructed from the LANtastic(R) message in the
- following way:
-
- MHS
- header Construction
- ------ ------------
-
- To: will be taken from the "MHS ADDRESS" in the translation table
- or from the first line(s) of the message if it is a "one-off"
- address.
-
- From: will be constructed as your MHS address. The recipient can
- just reply to your message using this address and the reply
- will be delivered to you.
- Example generated "From:" address:
- LANTMAIL @FRANGO {LANtastic: S=SERVER1; U=MIKE;}
-
- Date: will be taken from the date/time the LANtastic(R) message was
- sent.
-
- Subject: will be copied from the LANtastic(R) message's "Comment"
- field.
-
-
- => Sending LANtastic(R) Mail binary or voice files
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 6
-
-
- If the LANtastic(R) message you are sending is a binary file, you should
- select "Send Voice file". This will tell the gateway to convert the
- LANtastic(R) message body to an MHS attachment. If you send your binary
- files as text files instead of voice files, the recipient will receive a
- garbage message.
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 7
-
-
- INSTALLATION
-
- Now that you know how FLASH-Gate(TM) works, it is time to install it.
- Follow the steps below to complete the installation.
-
-
- ==> Gateway installation
-
- Take your MHS server off-line (stop the MHS program). Go the MHS
- server/host. (You must have a working MHS installation before you can
- install FLASH-Gate(TM)). Make sure the currently logged-in user has
- write/create directory rights/privileges to the MHS directory. The MHS
- server/host login must also have SuperMail (M) privilege on all the
- LANtastic(R) servers that it will pick up/deliver mail to/from. (Set
- SuperMail privilege by starting NET_MGR, select "Individual Account
- Management", select the MHS user/login name, move to the "Privileges"
- field and press "M".)
-
- Insert the FLASH-Gate(TM) diskette in the diskette drive. Type:
-
- "A:INSTALL" (or "B:INSTALL") and press ENTER
-
- Follow the onscreen instructions. When the installation is complete, you
- have installed the FLASH-Gate(TM) MHS gateway.
-
-
- ==> Address translation table LANTMAIL.TAB
-
- As explained in the previous chapters, you must enter addresses in the
- translation table LANTMAIL.TAB before you can send any messages to/via
- MHS from LANtastic(R) Mail. You can edit the table file with any kind of
- text editor or word processor that can read and write standard ASCII
- files. The full path of the table is:
-
- \MHS\MAIL\GATES\LANTMAIL\PUBLIC\LANTMAIL.TAB
-
- Enter the addresses as described in section "Addressing an MHS user in
- LANtastic(R) Mail". Make sure that all the aliases start with the
- characters "MHS:".
-
-
- ==> Entering "aliases" as LANtastic(R) usernames
-
- If you desire, it is possible to pick the remote (MHS) addresses from
- the LANtastic(R) user list when you send LANtastic(R) Mail messages. To
- be able to this, the aliases/shortnames for the addresses must be
- entered as LANtastic(R) users in NET_MGR.
-
- However, it is not necessary to do this. LANtastic(R) Mail allows you to
- enter addresses/usernames that are not defined on the server, and
- FLASH-Gate(TM) will pick up the message anyway, as long as the
- alias/address is defined in LANTMAIL.TAB.
-
- To enter the aliases/addresses in the LANtastic(R) user list, start
- NET_MGR, select "Individual Account Management" and enter the
- aliases/shortnames. Make sure you spell the alias exactly the same way
- as in LANTMAIL.TAB. Also set the "Number of Concurrent Logins" to 0 so
- that noone can login using these usernames.
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 8
-
-
- That does it! Now you are ready to try it out!
-
- Good luck and Have fun!
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 9
-
-
- TROUBLESHOOTING
-
- If you are getting error messages, please check them against the proper
- list below and follow the recommendations. If nothing helps, send a
- message to NICK Systems technical support. Technical support is
- preferably reached via MHS as "TECH @COLORSHP" via NHUB or direct
- 310-841-2074. Please supply a detailed description together with your
- FLASH-Gate(TM) version and serial number and also your MHS version.
- Thanks for your patience!
-
-
- ==> User and addressing errors
-
-
- => Non-delivery of LANtastic(R) Mail message
-
- My LANtastic(R) Mail message never gets picked up by the gateway. What
- is wrong?
- * First, check that your MHS is running and has gone through a full
- cycle.
- * Secondly, verify that the MHS host/server is logged in to the
- LANtastic(R) server the message was sent on.
- * Third, check that your address is correct. The "ALIAS" that you
- enter in the "Enter User to Receive Mail" field must be entered in
- the LANTMAIL.TAB file and it also has to start with the letters
- "MHS:".
- * If this did not help, then finally check the INPOST.ERR file (as
- described in the section "Gateway error messages") which will hold
- an error message if the gateway failed.
-
-
-
-
-
- => Non-delivery of MHS message
-
- When I try to send a message to a LANtastic(R) user via MHS and
- FLASH-Gate(TM) I get the following message back:
-
- ******************************************************************
- To: CJ @FRANGO (Carl-Johan L fstedt)
- From: LANTMAIL @FRANGO
- Subject: Non-delivery report
- Message-id: DB8C132C8133A0E0
- Via-host: FRANGO.FRANGO
- Date: 7-Jun-93 18:45:31
-
- The message you sent to:
-
- LANTMAIL@FRANGO {LANtastic: S=NONEXISTENT; U=CJ;}
-
- on 7-Jun-93 18:44 could not be delivered to:
-
- LANTMAIL @ FRANGO {LANtastic: S=NONEXISTENT; U=CJ;}
-
- Reason:
-
- Cannot access mail resource on LANtastic server in address.
- Please verify that the address is correct.
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 10
-
-
- Original message:
- ******************************************************
-
- Date: 7-Jun-93 18:44
- From: CJ @FRANGO (Carl-Johan L fstedt)
- To: LANTMAIL@FRANGO {LANtastic: S=NONEXISTENT; U=CJ;}
- Subject: This is a test message
- Application-name: MHS
- Message-id: 778C132C0133A0E0
-
- This is a test message from MHS E-mail to LANtastic Mail.
- ******************************************************************
-
- * This means that the message you sent didn't reach its destination
- because the gateway couldn't access the mail device on server
- "NONEXISTENT". It can be one of the following reasons for this:
- - the LANtastic(R) server "NONEXISTENT" does not exist
- - the MHS server/host is not logged in on "NONEXISTENT"
- - "NONEXISTENT" does not have a mail device (@MAIL)
- - the queue/spool area on "NONEXISTENT" is damaged or the disk
- is full!
-
- You can also get a non-delivery message for other reasons:
-
- ******************************************************************
- The message you sent to:
-
- LANTMAIL@FRANGO {LANastic: S=SERVER1; U=CJ;}
-
- on 7-Jun-93 18:44 could not be delivered to:
-
- LANTMAIL @ FRANGO {LANastic: S=SERVER1; U=CJ;}
-
- Reason:
-
- Invalid LANtastic address in above extended address.
- ******************************************************************
-
- * This means that there was something wrong in the MHS extended
- address part. Please refer to section "Addressing a LANtastic(R)
- Mail user in MHS". The problem in this case was that "LANTASTIC"
- was misspelled as "LANastic".
-
- Another non-delivery message can have this reason:
-
- ******************************************************************
- The message you sent to:
-
- LANTMAIL@FRANGO
-
- on 7-Jun-93 18:44 could not be delivered to:
-
- LANTMAIL @ FRANGO {}
-
- Reason:
-
- Invalid address. Extended address part missing.
- ******************************************************************
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 11
-
-
- * This means that the MHS extended address part was completely
- missing. The address needs an extended part as described in section
- "Addressing a LANtastic(R) Mail user in MHS".
-
-
-
- ==> Installation error messages
-
- Cannot create gateway (errorcode CODE). Please run manual installation.
- * The installation failed. Contact NICK Systems.
-
- Cannot start MHSUSER program. Please verify your MHS installation.
- * The installation program cannot find the MHSUSER program. Make sure
- that your MV variable is correctly set. (For example, if you have
- installed MHS on "F:\" you should have the "SET MV=F:\" command on
- the workstation).
-
- Can't open INSTALL.INF on this drive! Select another drive.
- * The installation program cannot find the INSTALL.INF file. Your
- installation disk is incomplete. Contact NICK Systems.
-
- Couldn't add gateway. Try once to select another name.
- * Gateway name already used as a hostname in MHS. Try using another
- name.
-
- Invalid INSTALL.INF
- * Damaged file. Your installation disk is damaged. Contact NICK
- Systems.
-
- Invalid installation disk: "FILE" is missing on "DISK"
- * Your installation disk is incomplete. Contact NICK Systems.
-
- MHS is currently running. Please stop the MHS program on the MHS server.
- * The MHS program is running. The program must be stopped before the
- installation can continue.
-
- MHS requires (administrators) password. Please supply.
- * Your MHS has been setup with an administrators password. You need
- to supply that password to continue the installation.
-
- MV environment variable not defined
- * The MV variable has not been set at the workstation. Set MV to
- point to your MHS installation. (For example, if you have installed
- MHS on "F:\" you should have the "SET MV=F:\" command on the
- workstation).
-
-
- ==> Gateway error messages
-
- When the gateway encounters an error, the error message gets written to
- the INPOST.ERR file located in the gateways PUBLIC directory.
- (\MHS\MAIL\GATES\LANTMAIL\PUBLIC\INPOST.ERR)
-
- Cannot close mail device (LANtasticMail:Send)
- * The disk (that the LANtastic(R) queue/spool area resides on) is
- probably full.
-
- Cannot close MHS file (Message:Write)
- * The disk (that MHS resides on) is probably full.
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 12
-
-
- Cannot delete message from [USERNAME] (Inpost:LANtasticToMHS)
- * Only the sender or SuperMail user can delete this message. The MHS
- server/host needs SuperMail privileges. See the "Installation"
- section.
-
- Cannot open body/text file (LANtasticMail:Read)
- * Cannot access queue entry/spooled file. The LANtastic(R)
- queue/spool area may be corrupt.
-
- Cannot open mail device on Server [SERVER] (LANtasticMail:Send)
- * Either the MHS Server/host is not logged in on "SERVER", or
- "SERVER" has no mail device.
-
- Cannot open MHS file (Message:Write)
- * The disk (that MHS resides on) is probably full.
-
- Cannot open source file [FILENAME] (LANtasticMail:Send)
- * "FILENAME" is either locked or missing.
-
- Cannot open table file [FILENAME] (AddressTable:Read)
- * The LANTMAIL.TAB is missing from your installation.
- It is supposed to be located in the
- \MHS\MAIL\GATES\"LANTMAIL"\PUBLIC\ subdirectory. Reinstall
- FLASH-Gate(TM).
-
- Cannot read message [FILENAME] (MHSToLANtastic)
- * Invalid (non-MHS) message!
-
- Cannot send file (Message:Send)
- * The disk (that MHS resides on) is probably full.
-
- Cannot send message. (Inpost:MHSNonDelivery)
- * Cannot send delivery report for message with invalid address. The
- disk (that MHS resides on) is probably full.
-
- Cannot send message from [USERNAME] (Inpost:LANtasticToMHS)
- * The disk (that MHS resides on) is probably full.
-
- Cannot Set queue entry (LANtasticMail:Send)
- * The gateway couldn't add the message to the queue. The LANtastic(R)
- queue/spool area may be corrupt or the disk might be full.
-
- Cannot set raw mode on mail device on Server [SERVER]
- (LANtasticMail:Send)
- * Something is wrong with the mail device. Try to send a binary
- message manually from the MHS server/host username/login.
-
- Cannot write. (LANtasticMail:Send)
- * Cannot write to the LANtastic(R) mail device. The disk (that the
- LANtastic(R) queue/spool area resides on) is probably full.
-
- Cannot write attachment (Message:Send)
- * The disk (that MHS resides on) is probably full.
-
- Cannot write to mail device on Server [SERVER] (LANtasticMail:Send)
- * The disk (that the LANtastic(R) queue/spool area resides on) is
- probably full.
-
- Invalid signature (Message:Read)
- FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 13
-
-
- * The file/message has an invalid MHS signature and is probably not
- an MHS message.
-
- Invalid (too long) signature (Message:SetSignature)
- * The file/message has an invalid MHS signature and is probably not
- an MHS message.
-
- License file missing or damaged
- * The FLASH-Gate(TM) license file cannot be found or is damaged.
- Reinstall FLASH-Gate(TM).
-
- Send-to missing in message [FILENAME] (MHSToLANtastic)
- * The message does not have the "Send-to:" field and is invalid.
-
- Sender missing in message. (Inpost:MHSNonDelivery)
- * The message does not have the "Sender:" field and is invalid.
-
- Signature missing (Message:Read)
- * The file/message does not have an MHS signature and is probably not
- an MHS message.
-
- Trial package license has expired (TRIAL VERSION ONLY).
- * The trial period of your program is over. Contact NICK Systems for
- a retail package.